home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 36 / dvsi1_11.zip / MANPAGES.DOC < prev    next >
Text File  |  1991-08-18  |  22KB  |  623 lines
  1. NAME
  2.      df - free and used disk space
  3.  
  4. SYNOPSIS
  5.      df [/cn /r /p /?] [<drive list>]
  6.  
  7. DESCRIPTION
  8.      DF reports on the disk space available all hard drives.  Its
  9.      output looks like this:
  10.  
  11.      Drive   Total    Used    Free %Used Label
  12.      C:      4864K   2768K   2096K   57% SYSTEM
  13.      D:     20810K  10068K  10742K   48% OLDDRIVE
  14.      E:     16576K  15136K   1440K   91% APPLICATNS
  15.      F:     20190K   7922K  12268K   39% DATA
  16.  
  17.      If <drive list> is ommitted, DF finds all drives, such as
  18.      network drives, higher than C: and includes them in the list.
  19.      With the /c option, DF will dynamically watch the available
  20.      drives.  If a SUBST command is used or a network drive is added, DF
  21.      will update its list to include that drive.
  22.  
  23. OPTIONS
  24.      Options are case sensitive and may be strung together: /c4/r
  25.  
  26.      /cn
  27.      Continuously update the list every n seconds.  Normally, df
  28.      lists the disk space and exits.  This option is most useful when
  29.      df is used in its own window.  n must be an integer between
  30.      0 and 65535.  Hitting any key will stop the listing and
  31.      cause df to exit.
  32.  
  33.      /r
  34.      Resize the window to fit exactly the number of drives in the
  35.      system.  Useful with /c option.
  36.  
  37.      /p
  38.      Print "Press any key to continue..." and wait for keystroke
  39.      before exiting.
  40.  
  41.      /?
  42.      Display a help screen.
  43.  
  44.      <drive list>
  45.      If specified, report only on the drives the list.  The list
  46.      is 1 or more drive names with no separating blanks.  Case
  47.      is not important.  For example, to report only on drives
  48.      C: and E: and F:, <drive list> would be CEF.  If no drive list
  49.      is specifed, all drives
  50.  
  51. BUGS
  52.      If using /c and /r, the maximum size of the window must be
  53.      as large as the (max # of drives+1) or strange things will happen.
  54.  
  55. Last Updated: August 18, 1991
  56.  
  57. ----------------------------------------------------------------------------
  58.  
  59.  
  60. NAME
  61.      dvsixdi - External Device Interface for DVSI
  62.  
  63. SYNOPSIS
  64.      In autoexec.bat:
  65.  
  66.      [loadhi] dvsixdi.com
  67.  
  68. DESCRIPTION
  69.      DVSIXDI is the heart of DVSI.  It keeps track of the processes
  70.      that DESQview starts and stops, as well as the CPU time of each
  71.      process and other information.  Basically, whenever DESQview
  72.      does something important, it calls DVSIXDI to record what is
  73.      happening.
  74.  
  75.      DVSIXDI should be installed before DESQview is run.  It is
  76.      best to put it in AUTOEXEC.BAT.  It will take up about
  77.      1.2K of memory after it exits.  To minimize the memory it requires,
  78.      load it (and any other TSRs) before you set your PATH and
  79.      other environment variables.  Preferrably, it should be loaded
  80.      in high memory, but this is not required.
  81.  
  82.      DVSIXDI may error out and not load.  The possible error messages
  83.      are:
  84.  
  85.      Error: Already Installed
  86.           You can only load DVSIXDI once.
  87.  
  88.      Error: No available slots
  89.           You have too many TSRs loaded that use the Multiplex interrupt
  90.           2F.  DVSIXDI cannot be loaded until an interrupt 2F slot is
  91.           available.
  92.  
  93.      DVSIXDI requires at least version 2.26 of DESQview.
  94.  
  95.      Other programs can communicate with DVSIXDI.  Please read
  96.      the distribution information in README.1ST; I retain the
  97.      copyright for this material and I do not allow modification
  98.      of the DVSI package.
  99.  
  100.      I do not guarantee anything about the future of the DVSIXDI
  101.      interface except for the installation check and the version check.
  102.      The interface for version 1.10 is
  103.  
  104.      AX=0de01h  BX=7575h  CX=function
  105.  
  106.      Function
  107.      00h - Installation check
  108.            Returns AL=ffh if installed
  109.  
  110.      01h - Notification on: not currently used
  111.  
  112.      02h - Notification off: not currently used
  113.  
  114.      03h - Get application records
  115.            Return
  116.              CX = number of application records
  117.              ES:DI pointer to array of application records
  118.              AX = 1 if OK, 0 if not OK
  119.              BX = last instantaneous time slice in 1/100 secs
  120.  
  121.            ES:DI points to the data structure in use.  I recommend
  122.            that you start a critical section, make this call, make
  123.            a copy of the records, and end the critical section.  Only
  124.            those records that have (flags & 0x80) true are valid, but
  125.            there are 15 records total.
  126.  
  127.            Application record:
  128.            app_rec_t struc
  129.                    flags           db ?  ;See below
  130.                    openkeys        dw ?  ;Keys on Open Window menu
  131.                    appnum          dw ?  ;Switch windows #
  132.                    handle          dw ?  ;Segment of handle of process
  133.                    numtasks        dw ?  ;Number of tasks including self
  134.                    mapcntx         dw ?  ;Mapping context of process
  135.                    t_start         dd ?  ;DVSI clock value at process's start
  136.                    t_getcpu        dd ?  ;DVSI clock when last got CPU
  137.                    t_giveupcpu     dd ?  ;DVSI clock when last gave up CPU
  138.                    t_cpu           dd ?  ;CPU time since start
  139.                    t_cpu_last      dd ?  ;CPU time at instant. time start ago
  140.                    t_cpu_inst      dd ?  ;CPU time in last instant. time secs
  141.                    hook            dd ?  ;Hook for other programs
  142.            app_rec_t ends
  143.  
  144.                The flags field can be an ORing of:
  145.                    04h   ;This is DV system task
  146.                    80h   ;Valid record (used internally by DVSIXDI)
  147.                These flags are not currently used:
  148.                    01h   ;This task swapped out
  149.                    02h   ;This task has keyboard
  150.  
  151.                DVSI clock value of 0 is the time DESQview is started.
  152.                Clock values are in ticks (approx 1/18.206 seconds).
  153.  
  154.                The Instantaneous Time is approximately 10 seconds.  The
  155.                t_cpu_last field is the value of the t_cpu field before
  156.                the current Instantaneous Time period started.  The
  157.                t_cpu_inst field is the amount of cpu time in the last
  158.                Instantaneous Time period (t_cpu - t_cpu_last).
  159.  
  160.      04h - Get Version
  161.           Return AH=Major, AL=Minor (1.10 is 010Ah)
  162.  
  163.      05h - Get Time since DV started
  164.           Return DX:AX = ticks since DV started
  165.  
  166.      06h - Get Task Switches
  167.           Return DX:AX = # of task switches since DV start
  168.                     CX = # of task switches in last instantaneous time
  169. BUGS
  170.      DVSIXDI only keeps track of 15 processes at a time. Anything
  171.      started after 15 is ignored completely, and never seen again
  172.      by DVSIXDI except in the calculation of number of task switches.
  173.  
  174.  
  175. Last updated: August 18, 1991
  176.  
  177. ----------------------------------------------------------------------------
  178.  
  179. NAME
  180.      kill - Kill a DESQview process
  181.  
  182. SYNOPSIS
  183.      kill [/p /?] <process_id>
  184.  
  185. DESCRIPTION
  186.      KILL "kills" a DESQview process.  It works just like "Close Window"
  187.      except that it will kill the process even if the "Allow Close
  188.      Window Command" is "N" in the DVP file.  This command is dangerous,
  189.      because you could easily lose data if you don't save before
  190.      using kill.  It is much better to exit a program (especially
  191.      non-DESQview programs) from the program itself.
  192.  
  193.      The process to be killed is unswapped, brought to the top,
  194.      and killed.  Kill then displays the handle of the killed process.
  195.  
  196.      KILL requires DVSIXDI 1.1 to be installed.
  197.  
  198. OPTIONS
  199.      All options are case sensitive.
  200.  
  201.      /p
  202.      When the process is killed, print "Press any key to
  203.      continue..." and wait for a keystroke.
  204.  
  205.      /?
  206.      Print a help message summarizing the options.
  207.  
  208.      <process_id>
  209.      The process to be killed. If <process_id> is 4 digits, it is
  210.      interpreted as a hex DESQview process handle from PS.  If it is
  211.      less than 4 digits, it is interpreted as a Switch Windows number.
  212.      A leading "%" is ignored for you Unix junkies.
  213.  
  214. BUGS
  215.      Some programs are determined not to die. They may require a
  216.      keystroke to make them go.
  217.  
  218. Last Updated: August 18, 1991
  219.  
  220. ----------------------------------------------------------------------------
  221.  
  222. NAME
  223.      perf - DESQview CPU performance statistics
  224.  
  225. SYNOPSIS
  226.      perf [/cn /p /?]
  227.  
  228. DESCRIPTION
  229.      PERF displays DESQview's performance.  It requires DVSIXDI 1.1
  230.      to be installed.
  231.  
  232.      PERF's output looks like this:
  233.  
  234.                         INSTANT      TOTAL
  235.      CPU Utilization          5%        36%
  236.      Task Switches           10        500
  237.      Task Switches/s        1.0        1.5
  238.      Time (1/100 s)        1011      75067
  239.  
  240.      Two columns of information are presented.  The statistics in the
  241.      INSTANT column represent the performance averaged over approximately
  242.      the last 10 seconds, while the TOTAL column represents the performance
  243.      averaged over the entire time DESQview has been running.
  244.  
  245.      CPU Utilization
  246.      The percentage of time spent running programs other than the
  247.      DV System Task.
  248.  
  249.      Task Switches
  250.      Number of times that DESQview has switched to a different task.
  251.  
  252.      Task Switches/s
  253.      Number of task switches per second during the time period.
  254.  
  255.      Time
  256.      The amount of time in 1/100 seconds that was used to calculate
  257.      the statistics.  The INSTANT column may be at up to 10 seconds old.
  258.  
  259. OPTIONS
  260.      All options are case sensitive.  Options may be strung together:
  261.      /c4/p
  262.  
  263.      /cn
  264.      Continuously update the statistics every n seconds.  Normally, perf
  265.      lists the statistics and exits.  This option is most useful when
  266.      perf is used in its own window.  n must be an integer between
  267.      0 and 65535.  Hitting any key will stop the listing and
  268.      cause perf to exit.  A good value for n is 10 seconds, since
  269.      DVSIXDI updates the INSTANT information every 10 seconds.
  270.  
  271.      /p
  272.      When the listing is complete, print "Press any key to
  273.      continue..." and wait for a keystroke.  Helpful if you are
  274.      not using /c and you want to use perf in its own window.  Will
  275.      work with the /c option.
  276.  
  277.      /?
  278.      Prints a help screen.  If any bad options are given, this
  279.      screen will automatically be printed.
  280.  
  281. BUGS
  282.      Integer math is used for the calculations; truncation rather than
  283.      rounding occurs in the least significant digit.
  284.  
  285.      The INSTANT column gives strange numbers during the first 10 seconds
  286.      after DESQview is started.
  287.  
  288. Last Updated: August 5, 1991
  289.  
  290. ----------------------------------------------------------------------------
  291.  
  292. NAME
  293.      ps - DESQview process status
  294.  
  295. SYNOPSIS
  296.      ps [/cn /dpath /p /r /l /?] [<process_id>]
  297.  
  298. DESCRIPTION
  299.      PS provides information on the current DESQview processes.
  300.      It requires DVSIXDI 1.1 to be installed.  Without the /l option,
  301.      PS's output looks like this:
  302.  
  303.      HNDL SW TK MAP  TTLMEM SYSMEM  L SYS  CPUTIME CPU UT KY NAME
  304.      d662 ?   0 95f6 641680 278512  276144  433516  89.2%    DV System Task
  305.      cf9b 1   1 0fe8  16464   1632    1088       0   0.0% CC Clock & Calendar
  306.      d027 2   1 1c34 ?????? Swappds ??????    6764   5.1% WP WordPerfect 5
  307.      cfe1 3   1 1b52 Swappd    592    1088     344   6.7% MF Quarterdeck Manifest
  308.  
  309.      The columns are described below:
  310.  
  311.      HNDL
  312.      The hexadecimal segment of the process's handle, similar to UNIX's PID.
  313.  
  314.      SW
  315.      The number appearing on the Switch Windows menu for this
  316.      task.  Applications which are "orphaned" and do not appear
  317.      on the Switch Windows menu, as well as the DV system task, will
  318.      contain a "?" in this column.
  319.  
  320.      TK
  321.      The number of separate tasks, including itself, that the
  322.      application has started.  For most programs, this will show
  323.      1, but some DESQview specific programs may use more than one
  324.      task.
  325.  
  326.      MAP
  327.      The hexadecimal mapping context of the application.  This number
  328.      is used with a DESQview API call to guarantee that the program
  329.      is in conventional memory.
  330.  
  331.      TTLMEM
  332.      The total memory, in bytes, used by the application.  If
  333.      "Swappd" appears in this column, the process's memory is
  334.      swapped out.  If system memory is swapped out, a "??????"
  335.      will appear in the field because the real value cannot be
  336.      determined.
  337.  
  338.      SYSMEM
  339.      The system memory, in bytes, used by the application. If
  340.      "Swappd" appears in this column, the process's system memory is
  341.      swapped out.  If an "s" is appended to the value, the system
  342.      memory resides in shared memory (see Wordperfect, above).
  343.  
  344.      L SYS
  345.      The largest block of system memory, in bytes, available to
  346.      the application. A "??????" implies that the value cannot be
  347.      determined.
  348.  
  349.      CPUTIME
  350.      Approximate amount CPU Time in 1/100 seconds for the process.
  351.      The time is actually only accurate to about 6/100 of a second.
  352.  
  353.      CPU UT
  354.      Approximate percentage of CPU time that the process has used in
  355.      the last approximately 10 seconds.  This column may be at most
  356.      10 seconds old.  The percentage for the DV System Task is
  357.      basically unused CPU time.
  358.  
  359.      KY
  360.      The keys used to open the application.
  361.  
  362.      NAME
  363.      The name of the application, as shown on the Open Window
  364.      menu.
  365.  
  366.      If the /l option is used, the output looks a little messier:
  367.  
  368.      HNDL SW TK MAP  TTLMEM SYSMEM  L SYS  CPUTIME CPU UT KY NAME
  369.      kbd  mbx  obq  cursor  positn  visible logcl dispd
  370.  
  371.      d3e2  ?  0 0249 654016 384752  354128  723011  97.2%    DV System Task
  372.      014d d3e2 0197 ( 1,17) ( 0,56) ( 0, 0) 17x24 17x24
  373.  
  374.      ce55  ?  1 1044  16448   1632    1088       6   0.0% CC Clock & Calendar
  375.      014d ce55 0197 ( 0,33) (58,15) ( 0, 0)  1x45  1x35
  376.  
  377.      cefe  2  1 1aca 589808    480     432   55865   0.0% BD Big DOS
  378.      014d cefe 0197 (39, 6) ( 0, 0) ( 0, 0) 60x80 60x80
  379.  
  380.      cf4f  3  1 1fe0  32736    208     208   33714   2.8% PS DVSI ps
  381.      014d cf4f 0197 (16,15) (11, 0) ( 0, 0) 50x80 28x80
  382.  
  383.  
  384.      The additional columns in the second line for each process are:
  385.  
  386.      KBD MBX OBQ
  387.      The hex offsets for the process's default keyboard, mailbox and
  388.      objectq.  The segments are the same as the process's handle.
  389.  
  390.      CURSOR
  391.      The position of the cursor relative to the window's origin,
  392.      (row, column).
  393.  
  394.      POSITN
  395.      The upper left corner of the window on the screen, (row, column).
  396.  
  397.      VISIBLE
  398.      The coordinate of the upper left corner of the displayed window,
  399.      (row, column).  This number can be changed by using "Rearrange -
  400.      Scroll".
  401.  
  402.      LOGCL
  403.      Logical, or maximum, size of the window, in rows x columns.
  404.  
  405.      DISPD
  406.      Displayed size of the window, in rows x columns.
  407.  
  408. OPTIONS
  409.      All options are case sensitive.  Options may be strung together:
  410.      /c4/p/d\dv
  411.  
  412.      /cn
  413.      Continuously update the list every n seconds.  Normally, ps
  414.      lists the status and exits.  This option is most useful when
  415.      ps is used in its own window.  n must be an integer between
  416.      0 and 65535 (I don't know why you'd want to wait 18 hours,
  417.      but you can!).  Hitting any key will stop the listing and
  418.      cause ps to exit.
  419.  
  420.      /p
  421.      When the listing is complete, print "Press any key to
  422.      continue..." and wait for a keystroke.  Helpful if you are
  423.      not using /c and you want to use ps in its own window.  Will
  424.      work with the /c option.
  425.  
  426.      /dpath
  427.      Find DESQVIEW.DVO in the directory specified by path.
  428.      DESQVIEW.DVO is the file that the Open Window menu gets its
  429.      info from, and where ps finds the NAME and KEY fields.  If
  430.      this option is not specified, ps will first look in C:\DV, then
  431.      search the PATH environment variable for the directory.
  432.      This will usually work because the DESQview system directory
  433.      name should be in the PATH.  However, I have noticed that
  434.      the environment does  not get passed if ps is started from
  435.      its own window, so I provided this option.
  436.  
  437.      /r
  438.      Resize the window according to the number of processes in the list.
  439.      The window is made 80 columns wide and high enough for all the
  440.      processes to be displayed, and is moved left to column 0.
  441.      If using /c and the number of processes changes, the window size
  442.      is changed also.
  443.  
  444.      /l
  445.      Long listing: more info than you really wanted to know about each
  446.      process.
  447.  
  448.      /?
  449.      Prints a help screen.  If any bad options are given, this
  450.      screen will automatically be printed.
  451.  
  452.      <process_id>
  453.      If <process_id> is specified, only display info for that process.
  454.      Normally, PS displays all processes.  <process_id> is interpreted
  455.      as a hexadecimal handle if it is 4 digits.  Otherwise, it
  456.      is considered a switch windows number.
  457.      A leading "%" is ignored for you Unix junkies.
  458.  
  459. BUGS
  460.      Any processes started after 15 have been started will be ignored.
  461.  
  462.      Running Add A Program or Delete A Program no longer confuses
  463.      PS.  However, if you are using /c and you add or delete programs,
  464.      and run them, PS may display "(not available)" in the NAME
  465.      field.  This is because PS does not close and reopen DESQVIEW.DVO
  466.      each iteration.  If the "(not available)" bothers you, exit
  467.      PS and restart.
  468.  
  469.  
  470. Last Updated: August 18, 1991
  471.  
  472.  
  473. ----------------------------------------------------------------------------
  474.  
  475. NAME
  476.      memstat - DESQview memory status
  477.  
  478. SYNOPSIS
  479.      memstat [/cn /p /?]
  480.  
  481. DESCRIPTION
  482.      MEMSTAT is an alternative to DESQview's Memory Status program.
  483.      It takes up much less CPU time, although it is larger than
  484.      Memory Status.  It can also be used at the DOS command line,
  485.      while Memory Status cannot.
  486.  
  487.      MEMSTAT displays the same information as memory status, and
  488.      adds another column.  The output looks like this:
  489.  
  490.      TYPE  TOTAL LARGEST AVAILABLE USED
  491.      Conv   590K    345K      375K  36%
  492.      Exp   2912K    576K     1184K  59%
  493.      Com  25600   10668     10804   58%
  494.  
  495.      The columns are:
  496.  
  497.      TYPE
  498.      The type of memory described in this row.  "Conv" is conventional
  499.      memory, or memory between 0 and 640K.  "Exp" is expanded
  500.      (EMS or EEMS) memory.  "Com" is DESQview's common memory
  501.      area.
  502.  
  503.      TOTAL
  504.      The total amount of memory in the system.
  505.  
  506.      LARGEST
  507.      The largest block of available memory.
  508.  
  509.      AVAILABLE
  510.      The total amount of memory currently available.
  511.  
  512.      USED
  513.      The percentage of memory that is currently being used.
  514.  
  515. OPTIONS
  516.      All options are case sensitive.  Options may be strung together:
  517.      /c4/p
  518.  
  519.      /cn
  520.      Continuously update the statistics every n seconds.  Normally, memstat
  521.      lists the statistics and exits.  This option is most useful when
  522.      memstat is used in its own window.  n must be an integer between
  523.      0 and 65535.  Hitting any key will stop the listing and
  524.      cause memstat to exit.
  525.  
  526.      /p
  527.      When the listing is complete, print "Press any key to
  528.      continue..." and wait for a keystroke.  Helpful if you are
  529.      not using /c and you want to use perf in its own window.  Will
  530.      work with the /c option.
  531.  
  532.      /?
  533.      Prints a help screen.  If any bad options are given, this
  534.      screen will automatically be printed.
  535.  
  536. Last Updated: August 11, 1991
  537.  
  538. --------------------------------------------------------------------------
  539.  
  540. NAME
  541.      uptime - Print amount of time DESQview has been running
  542.  
  543. SYNOPSIS
  544.      uptime [/p /?]
  545.  
  546. DESCRIPTION
  547.      UPTIME reports the amount of time that DESQview has been running
  548.      in the following format:
  549.  
  550.      DESQview has been running for 2 days 1 hour 5 minutes and 21.34 seconds
  551.      Since Fri Aug 02 18:23:45 1991
  552.  
  553.      UPTIME requires DVSIXDI 1.1 to be installed.
  554.  
  555. OPTIONS
  556.      All options are case sensitive.
  557.  
  558.      /p
  559.      After the time is displayed, print "Press any key to
  560.      continue..." and wait for a keystroke.
  561.  
  562.      /?
  563.      Print a help message summarizing the options.
  564.  
  565.  
  566. Last Updated: August 2, 1991
  567.  
  568. --------------------------------------------------------------------------
  569.  
  570. NAME
  571.      wn - Manipulate DESQview windows
  572.  
  573. SYNOPSIS
  574.      wn [/?] <command> [<process_id>]
  575.  
  576. DESCRIPTION
  577.      WN contains a set of commands for manipulating DESQview windows.
  578.      Windows may be killed, raised, lowered, topped, hidden or
  579.      suspended.
  580.  
  581.      Killing a window is just like the DVSI's KILL command.  Read
  582.      KILL's man page for more information.
  583.  
  584.      Raising a window gives it the keyboard.  It is equivalent to
  585.      using the "Switch Windows" menu.
  586.  
  587.      Lowering a window puts it at the bottom of the window stack,
  588.      and takes away the keyboard.
  589.  
  590.      Topping a window brings it to the top of the window stack, but
  591.      does not give it the keyboard.
  592.  
  593.      Hidding a window is works just like "Rearrange - Hide".
  594.  
  595.      Suspending a window hides it and doesn't give it any CPU time
  596.      while hidden.
  597.  
  598.      A suspended or hidden window may be unhidden by raising or
  599.      topping it.
  600.  
  601. OPTIONS
  602.  
  603.      /?
  604.      Print a help message
  605.  
  606.      <command> may be one of the following.  The first letter of the
  607.      command may be used as an abbreviation.  The command is
  608.      case-insensitive.
  609.      KILL
  610.      RAISE
  611.      LOWER
  612.      TOP
  613.      HIDE
  614.      SUSPEND
  615.  
  616.      If <process_id> is specified, that process's window is manipulated.
  617.      Otherwise, the current process's window is used.  If <process_id>
  618.      is 4 hex digits, it is interpreted as a handle.  Otherwise,
  619.      it is considered a Switch Windows number.
  620.      A leading "%" is ignored for you Unix junkies.
  621.  
  622. Last Updated: August 18, 1991
  623.